home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 3 / QRZ Ham Radio Callsign Database - Volume 3.iso / world / mac / contest / dxmapsea.hqx / DX Map 1.1.1 / DX Map Info < prev    next >
Text File  |  1992-09-05  |  6KB  |  131 lines
  1.  
  2. DX Map 1.1 by Len Saaf, NV2Z
  3.  
  4. Copyright 1990,1991,1992 Raleigh Associates
  5.  
  6. The following is from a help field that can be accessed from within the stack. 
  7. This stack requires the version of Hypercard to be 2.0 or greater.
  8.  
  9. This stack is freeware. It may be distributed in part or in whole provided that
  10. it is distributed for free.
  11.  
  12. This stack enables amateur radio operators to find the location, bearing, and
  13. other information for the 'DXCC' countries of the world. It also displays the
  14. day and night portions of the globe dynamically. 
  15.  
  16. DX Map features:
  17. Ñ  Your QTH is marked on the map and your local time appears above it (12 or 24
  18. hour format).
  19. Ñ  UTC is displayed at the bottom of the map.
  20. Ñ  A dynamic grayline is shown on the map showing the day and night portions of
  21. the globe.
  22. Ñ  A DXCC country can by selected by either choosing the country name from a
  23. list or by entering a callsign or prefix. The DXCC country is marked on the map
  24. and the following information is listed:
  25.       Ñ  Country name
  26.       Ñ  Continent
  27.       Ñ  CQ zone(s)
  28.       Ñ  ITU zone(s)
  29.       Ñ  Distance from your QTH in miles and kilometers
  30.       Ñ  Bearing in degrees from your QTH
  31.       Ñ  Callsign allocation
  32.       Ñ  The local time in the DXCC country is displayed above its location on
  33. the map
  34. Ñ  Your location and the remote location are fully adjustable.
  35.  
  36. Using DX Map:
  37.  
  38. To get Help:
  39. Read this or use Balloon Help.
  40.  
  41. To choose a DXCC country from a list of countries:
  42. If the scrolling list is not already visible at the left-hand side of the card,
  43. click the "Show List" button. Select a DXCC country by clicking on the name of
  44. the country. When the scrolling list is visible typing a letter will scroll the
  45. list to the first country that begins with that letter.
  46.  
  47. To choose a DXCC country from a prefix or callsign:
  48. Click the "Find Call" button and you will be prompted for a callsign or prefix.
  49.  
  50. To find the distance and bearing to any location on the map:
  51. Click and hold on the icon that marks the remote location. It is the one with
  52. the "X" cross. Move the icon to the desired location and release the mouse
  53. button. Note that the time at the remote location is not displayed since the
  54. remote time zone information is unknown.
  55.  
  56. To update the grayline immediately:
  57. Click on the "Sun" button.
  58.  
  59. To turn off the grayline display:
  60. Click on the "Sun" button while depressing the shift key. The sun button will
  61. turn black and the grayline will be removed. To reactive the grayline function
  62. click the sun button again with the shift key depressed.
  63.  
  64. Configuring DX Map
  65.  
  66. Changing your QTH:
  67. One way to change your QTH is to click and hold on the small button that marks
  68. your QTH. You can then drag it to any position. Your local time remains
  69. unchanged. Another way to change your QTH is to go to the configuration card by
  70. clicking on the small right arrow button at the lower right-hand corner of the
  71. map card. The configuration card lets you choose whether or not you want to use
  72. the information stored in your Mac's parameter RAM for your QTH information.
  73. This information can be set using the Map control panel, which is part of the
  74. Macintosh system software. If you choose not to use that information, uncheck
  75. the box and some fields and buttons will appear that will let you specify the
  76. latitude and longitude of your QTH. You can also click on the "By Call" button
  77. to enter the location by callsign or prefix (This will also set your local time
  78. difference from UTC).
  79.  
  80. To change your local time zone information:
  81. The difference between your local time and UTC can be set at the configuration
  82. card (see above). If you uncheck the "Time Zone" check box, controls will
  83. appear to let you enter your local UTC time difference.
  84.  
  85. Dealing with daylight savings time:
  86. On the configuration card there is a checkbox titled "Auto Daylight Savings."
  87. If this box is checked the stack will figure out whether or not DST (daylight
  88. savings time, a.k.a. summer time) is in effect in the USA and set the UTC time
  89. difference accordingly. (You still need to set your Mac's clock to the correct
  90. local time╤be it standard or daylight savings.) If you don't use summer time,
  91. or if the rules for it are different at your QTH, uncheck the  "Auto Daylight
  92. Savings" checkbox and use the radio buttons (that will appear) to choose
  93. between standard and daylight savings time. You can also modify the
  94. daylightsavingstime() function in the stack script to meet your needs. I have
  95. no data on the countries that use summer time so the time for remote locations
  96. is always standard time. Summer time is one hour later in most (if not all)
  97. cases.
  98.  
  99. To change the frequency at which the grayline is updated:
  100. See the notes in the 'openstack' handler in the stack script.
  101.  
  102. Bugs:
  103. Probably lots. The identification of DXCC countries from callsign surely has
  104. quite a few glitches. If any of the cards are deleted the stack will get very 
  105. confused. Best to make a copy just in case.
  106.  
  107. More info:
  108. I wrote 3 XFCNs for this stack:
  109. Ñ  "CallToNum" takes a callsign and returns the number of DXCC countries that
  110. could have that callsign followed by ID numbers for each of those DXCC
  111. countries.
  112. Ñ  "NumToInfo" takes one of those ID numbers and returns a bunch of info for
  113. that DXCC country. The info is from a list I got off rec.ham-radio.
  114. Ñ  "coords" takes 2 lattitude/longitude pairs and returns the distance between
  115. them and the bearing from the first to the second.
  116.  
  117. The source code to these 3 XFCNs is free for the asking. It is written in
  118. Pascal.
  119.  
  120. Thanks to Mike Hoenig, N5LTL, for suggestions and encouragement!
  121.  
  122. All bug reports, comments and/or suggestions are welcome. 
  123. My addresses are:
  124.  
  125. Len Saaf
  126. 40 Manitou Ave.
  127. Poughkeepsie, NY 12603
  128.  
  129. Internet: saaf@panix.com
  130. America Online: saaf
  131.